home *** CD-ROM | disk | FTP | other *** search
/ Halting the Hacker - A P…uide to Computer Security / Halting the Hacker - A Practical Guide to Computer Security.iso / rfc / rfc740.txt < prev    next >
Text File  |  1997-04-01  |  39KB  |  1,121 lines

  1.  
  2. RFC 740                                              RTB 42423 22 Nov 77
  3. NETRJS Protocol
  4.  
  5.  
  6.  
  7. Network Working Group                                          R. Braden
  8. Request for Comments: 740                                       UCLA-CCN
  9. NIC: 42423                                              22 November 1977
  10. Obsoletes: 189, 599
  11.  
  12.  
  13.  
  14.                             NETRJS PROTOCOL
  15.  
  16.  
  17.  
  18.  
  19. A.  Introduction
  20.  
  21.    NETRJS, a private protocol for remote job entry service, was defined
  22.    and implemented by the UCLA Campus Computing Network (CCN) for batch
  23.    job submission to an IBM 360 Model 91. CCN's NETRJS server allows a
  24.    remote user, or a daemon process working in behalf of a user, to
  25.    access CCN's RJS ("Remote Job Service") subsystem.  RJS provides
  26.    remote job entry service to real remote batch (card reader/line
  27.    printer) terminals over direct communications lines as well as to the
  28.    ARPANET.
  29.  
  30.    A batch user at a remote host needs a NETRJS user process to
  31.    communicate with the NETRJS server at the batch host. An active
  32.    NETRJS user process simulates a "Virtual Remote Batch Terminal", or
  33.    "VRBT".
  34.  
  35.    A VRBT may have virtual card readers, printers, and punches. In
  36.    addition, every VRBT has a virtual remote operator console. Using a
  37.    virtual card reader, a Network user can transmit a stream of card
  38.    images comprising one or more batch jobs, complete with job control
  39.    language ("JCL"), to the batch server host. The NETRJS server will
  40.    cause these jobs to be spooled into the batch system to be executed
  41.    according to their priority.  NETRJS will automatically return the
  42.    print and/or punch output images which are created by these jobs to
  43.    the virtual printer and/or card punch at the VRBT from which the job
  44.    was submitted. The batch user can wait for his output, or he can
  45.    signoff and signon again later to receive it.
  46.  
  47.    To initiate  a NETRJS session, the user process must execute a
  48.    standard ICP to a fixed socket at the server.  The result is to
  49.    establish a full-duplex Telnet connection for the virtual remote
  50.    operator console, allowing the VRBT to signon to RJS.  The virtual
  51.    remote operator console can then be used to issue commands to NETRJS
  52.    and to receive status, confirmation, and error messages from the
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Braden                                                          [page 1]
  60.  
  61. RFC 740                                              RTB 42423 22 Nov 77
  62. NETRJS Protocol
  63.  
  64.  
  65.  
  66.    server.  The most important remote operator commands are summarized
  67.    in Appendix D.
  68.  
  69.    Different VRBT's are distinguished by 8-character terminal id's,
  70.    which are assigned by the server site to individual batch users or
  71.    user groups.
  72.  
  73. B.  Connections and Protocols
  74.  
  75.    The protocol uses up to five connections between the user and server
  76.    processes.  The operator console uses a a full-duplex Telnet
  77.    connection. The data transfer streams for the virtual card reader,
  78.    printer, and punch each use a separate simplex connection under a
  79.    data transfer protocol defined in Appendix A. This document will use
  80.    the term "channel" for one of these simplex data transfer connections
  81.    and will designate a connection "input" or "output" with reference to
  82.    the server.
  83.  
  84.    A particular data transfer channel needs to be open only while it is
  85.    in use, and different channels may be used sequentially or
  86.    simultaneously. CCN's NETRJS server will support simultaneous
  87.    operation of a virtual card reader, a virtual printer, and a virtual
  88.    punch (in addition to the operator console) on the same VRBT process.
  89.    The NETRJS protocol could easily be extended to any number of
  90.    simultaneously-operating virtual card readers, printers, and punches.
  91.  
  92.    The NETRJS server takes a passive role in opening the data channels:
  93.    the server only "listens" for an RFC from the user process. NETRJS is
  94.    defined with an 8-bit byte size on all data channels.
  95.  
  96.    Some implementations of NETRJS user processes are daemons, operating
  97.    as background processes to submit jobs from a list of user requests;
  98.    other implementations are interactive processes executed directly
  99.    under terminal control by remote users. In the latter case, the VRBT
  100.    process generally multiplexes the user terminal between NETRJS, i.e.,
  101.    acting as the remote operator console, and entering local commands to
  102.    control the VRBT. Local VRBT commands allow selection of the files
  103.    containing job streams to be sent to the server as well as files to
  104.    receive job output from the server.  Other local commands would cause
  105.    the VRBT to open data transfer channels to the NETRJS server and to
  106.    close these channels to free buffer space or abort transmission.
  107.  
  108.    The user process has a choice of three ICP sockets, to select the
  109.    character set of the VRBT -- ASCII-68, ASCII-63, or EBCDIC. The
  110.    server will make the corresponding translation of the data in the
  111.    card reader and printer channels. (In the CCN implementation of
  112.    NETRJS, an EBCDIC VRBT will transmit and receive, without
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Braden                                                          [page 2]
  119.  
  120. RFC 740                                              RTB 42423 22 Nov 77
  121. NETRJS Protocol
  122.  
  123.  
  124.  
  125.    translation, "transparent" streams of 8-bit bytes, since CCN is an
  126.    EBCDIC installation). The punch stream will always be transparent,
  127.    outputting "binary decks"  of 80-byte records untranslated. The
  128.    operator console connections always use Network ASCII, as defined by
  129.    the Telnet protocol.
  130.  
  131.    The NETRJS protocol provides data compression, replacing repeated
  132.    blanks or other characters by repeat counts.  However, when the
  133.    terminal id is assigned, a particular network VRBT may be specified
  134.    to use no data compression.  In this case, NETRJS will simply
  135.    truncate trailing blanks and send records in a simple "op
  136.    code-length-data" form, called "truncated format" (see Appendix A).
  137.  
  138. C.  Starting and Terminating a Session
  139.  
  140.    The remote user establishes a connection to the NETRJS server by
  141.    executing an ICP to the contact socket 71 (decimal) for EBCDIC,
  142.    socket 73 (decimal) for ASCII-68, or to socket 75 (decimal) for
  143.    ASCII-63. A successful ICP results in a pair of connections which are
  144.    in fact the NETRJS operator console connections. NETRJS will send a
  145.    READY message over the operator output connection.
  146.  
  147.    The user (process) must now enter a valid NETRJS signon command
  148.    ("SIGNON terminal-id") through the virtual remote operator console.
  149.    RJS will normally acknowledge signon with a console message; however,
  150.    if there is no available NETRJS server port, NETRJS will indicate
  151.    refusal by closing both operator connections.  If the user fails to
  152.    enter a valid signon within 3 minutes, NETRJS will close the operator
  153.    connections. If the VRBT attempts to open data transfer channels
  154.    before the signon command is accepted, the data transfer channels
  155.    will be refused  with an error message to the VRBT operator console.
  156.  
  157.    Suppose that S is the even number sent in the ICP; then the NETRJS
  158.    connections have sockets at the server with fixed relation to S, as
  159.    shown in the following table:
  160.  
  161.    Channel                          Server Socket     User Socket
  162.    -------                          -------------     -----------
  163.    Remote Operator Console Input         S            U + 3 Telnet
  164.    Remote Operator Console Output        S + 1        U + 2 Telnet
  165.    Data Transfer - Card Reader #1        S + 2        any odd number
  166.    Data Transfer - Printer #1            S + 3        any even number
  167.    Data Transfer - Punch #1              S + 5        any even number
  168.  
  169.    Once the VRBT has issued a valid signon, it can open data transfer
  170.    channels and initiate input and output operations as explained in the
  171.    following sections.  To terminate the session, the VRBT may close all
  172.  
  173.  
  174.  
  175.  
  176.  
  177. Braden                                                          [page 3]
  178.  
  179. RFC 740                                              RTB 42423 22 Nov 77
  180. NETRJS Protocol
  181.  
  182.  
  183.  
  184.    connections.  Alternatively, it may enter a SIGNOFF command through
  185.    the virtual remote operator console.  Receiving a SIGNOFF, NETRJS
  186.    will wait until the current job output streams are complete and then
  187.    itself terminate the session by closing all connections.
  188.  
  189. D.  Input Operations
  190.  
  191.    A job stream for submission to the NETRJS server is a series of
  192.    logical records, each of which is a card image of at most 80
  193.    characters. The user can submit a "stack" of successive jobs through
  194.    the card reader channel with no end-of-job indication between jobs;
  195.    NETRJS is able to parse the JCL sufficiently to recognize the
  196.    beginning of each job.
  197.  
  198.    To submit a batch job or stack of jobs for execution, the user
  199.    process must first open the card reader channel by issuing an Init
  200.    for foreign socket S+2 and the appropriate local socket. NETRJS,
  201.    which is listening on socket S+2, will return an RTS command to open
  202.    the channel. When the channel is open, the user can begin sending his
  203.    job stream using the protocol defined in Apendix A.  For each job
  204.    successfully spooled, NETRJS will send a confirming message to the
  205.    remote operator console.
  206.  
  207.    At the end of the job stack, the user process must send an
  208.    End-of-Data transaction to initiate processing of the last job.
  209.    NETRJS will then close the channel (to avoid holding buffer space
  210.    unnecessarily).  At any time during the session, the user process can
  211.    re-open the card reader channel and transmit another job stack.  It
  212.    can also terminate the session and signon later to get the output.
  213.  
  214.    If the user process leaves the channel open for 5 minutes without
  215.    sending any bits, the server will abort (close) the channel. The user
  216.    process can abort the card reader channel at any time by closing the
  217.    channel;  NETRJS will then discard the last partially spooled job.
  218.    If NETRJS finds an error (e.g., transaction sequence number error or
  219.    a dropped bit), it will abort the channel by closing the channel
  220.    prematurely, and also inform the user process that the job was
  221.    discarded (thus solving the race condition between End-of-Data and
  222.    aborting).  The user process should retransmit only those jobs in the
  223.    stack that have not been completely spooled.
  224.  
  225.    If the user's process, NCP, or host, or the Network itself fails
  226.    during input, RJS will discard the job being transmitted.  A message
  227.    informing the user that this job was discarded will be generated and
  228.    sent to him the next time he signs on.  On the other hand, those jobs
  229.    whose receipt have been acknowledged on the operator's console will
  230.    not be affected by the failure, but will be executed by the server.
  231.  
  232.  
  233.  
  234.  
  235.  
  236. Braden                                                          [page 4]
  237.  
  238. RFC 740                                              RTB 42423 22 Nov 77
  239. NETRJS Protocol
  240.  
  241.  
  242.  
  243. E.  Output Operations
  244.  
  245.    The VRBT may wait to set up a virtual printer or punch and open its
  246.    channel until a STATUS message from NETRJS indicates output is ready;
  247.    or it may leave the output channel(s) open during the entire session,
  248.    ready to receive output whenever it becomes available.  The VRBT can
  249.    also control which one of several available jobs is to be returned by
  250.    entering appropriate operator commands.
  251.  
  252.    To be prepared to receive printer (or punch) output from its jobs,
  253.    the VRBT issues an Init for foreign socket S+3 or S+5 for printer or
  254.    punch output, respectively. NETRJS is listening on these sockets and
  255.    should immediately return an STR.  However, it is possible that
  256.    because of a buffer shortage, NETRJS will refuse the connection by
  257.    returning a CLS; in this case, try again later.
  258.  
  259.    When NETRJS has job output for a particular virtual terminal and a
  260.    corresponding open output channel, it will send the output as a
  261.    series of logical records using the protocol in Appendix A.  The
  262.    first record will consist of the job name (8 characters) followed by
  263.    a comma and then the ID string from the JOB card, if any.  In the
  264.    printer stream, the first column of each record after the first will
  265.    be an ASA carriage control character (see Appendix C). A virtual
  266.    printer in NETRJS has 254 columns, exclusive of carriage control;
  267.    NETRJS will send up to 255 characters of a logical record it finds in
  268.    a SYSOUT data set.  If the user wishes to reject or fold records
  269.    longer than some smaller record size, he can do so in his VRBT
  270.    process.
  271.  
  272.    NETRJS will send an End-of-Data transaction and then close an output
  273.    channel at the end of the output for each complete batch job; the
  274.    remote site must then send a new RFC to start output for another job.
  275.    This gives the remote site a chance to allocate a new file for each
  276.    job without breaking the output within a job.
  277.  
  278.    If the batch user wants to cancel (or backspace or defer) the output
  279.    of a particular job, he can enter appropriate NETRJS commands on the
  280.    operator input channel (see Appendix D).
  281.  
  282.    If NETRJS encounters a permanent I/O error in reading the disk data
  283.    set, it will notify the user via his console, skip forward to the
  284.    next set of system messages or SYSOUT data set in the same job, and
  285.    continue. If the user process stops accepting bits for 5 minutes, the
  286.    server will abort the channel. In any case, the user will receive
  287.    notification of termination of output data transfer for each job via
  288.    a remote console message.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295. Braden                                                          [page 5]
  296.  
  297. RFC 740                                              RTB 42423 22 Nov 77
  298. NETRJS Protocol
  299.  
  300.  
  301.  
  302.    If the user detects an error in the stream, he can issue a Backspace
  303.    (BSP) command from his console to repeat the last "page" of output,
  304.    or a Restart (RST) command to repeat from the last SYSOUT data set or
  305.    the beginning of the job, or he can abort the channel by closing his
  306.    socket.  If he aborts the channel, NETRJS will simulate a Backspace
  307.    command, and when the user re-opens the channel the job will begin
  308.    transmission again from an earlier point in the same data set.  This
  309.    is true even if the user terminates the current session first and
  310.    reopens the channnel in a later session; RJS saves the state of every
  311.    incomplete output stream.  However, before re-opening the channel he
  312.    can defer this job for later output, restart it at the beginning, or
  313.    cancel its output (see Appendix D).  Note that aborting the channel
  314.    is only effective if NETRJS has not yet sent the End-of-Data
  315.    transaction.
  316.  
  317.    If the user's process, NCP, or host or the Network itself fails
  318.    during an output operation, NETRJS will act as if the channel had
  319.    been aborted and the user signed off. NETRJS will discard the output
  320.    of a job only after receiving the RFNM from the last data transfer
  321.    message (containing an End-of-Data).  In no case should a NETRJS user
  322.    lose output from a batch job.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354. Braden                                                          [page 6]
  355.  
  356. RFC 740                                              RTB 42423 22 Nov 77
  357. NETRJS Protocol
  358.  
  359.  
  360.  
  361.                                APPENDIX A
  362.  
  363.                     Data Transfer Protocol in NETRJS
  364.  
  365.    1.  Introduction
  366.  
  367.       The records in the data transfer channels (for virtual card
  368.       reader, printer, and punch) are generally grouped into
  369.       transactions preceded by headers.  The transaction header includes
  370.       a sequence number and the length of the transaction.  Network byte
  371.       size must be 8 bits in these data streams.
  372.  
  373.       A transaction is the unit of buffering within the server software,
  374.       and is limited to 880 8-bit bytes. Transactions can be as short as
  375.       one record; however, those sites which are concerned with
  376.       efficiency should send transactions as close as possible to the
  377.       880 byte limit.
  378.  
  379.       There is no necessary connection between physical message
  380.       boundaries and transactions ("logical messages"); the NCP can
  381.       break a transaction arbitrarily into physical messages. The CCN
  382.       server starts each transaction at the beginning of a new physical
  383.       message, but this is not a requirement of the protocol.
  384.  
  385.       Each logical record within a transaction begins with an "op code"
  386.       byte which contains the channel identification, so its value is
  387.       unique to each channel but constant within a channel.  This choice
  388.       provides the receiver with a convenient way to verify
  389.       bit-synchronization, and it also allows an extension in the future
  390.       to true "multi-leaving" (i.e., multiplexing all channels within
  391.       one connection in each direction).
  392.  
  393.       The only provisions for transmission error detection in the
  394.       current NETRJS protocol are (1) the "op code" byte to verify bit
  395.       synchronization and (2) the transaction sequence number. Under the
  396.       NETRJS protocol, a data transfer error must abort the entire
  397.       transmission; there is no provision for restart.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413. Braden                                                          [page 7]
  414.  
  415. RFC 740                                              RTB 42423 22 Nov 77
  416. NETRJS Protocol
  417.  
  418.  
  419.  
  420.    2.  Meta-Notation
  421.  
  422.       The following description of the NETRJS data transfer protocol
  423.       uses a formal notation derived from that proposed in RFC 31 by
  424.       Bobrow and Sutherland. The notation consists of a series of
  425.       productions for bit string variables. Each variable name which
  426.       represents a fixed length field is followed by the length in bits
  427.       (e.g., SEQNUMB(16)).  Numbers enclosed in quotes are decimal,
  428.       unless qualified by a leading X meaning hex.  Since each hex digit
  429.       is 4 bits, the length is not shown explicitly in hex numbers.  For
  430.       example, '255'(8) and X'FF' both represent a string of 8 one bits.
  431.  
  432.       The meta-syntactic operators are:
  433.  
  434.          |     :alternative string
  435.  
  436.          [ ]   :optional string
  437.  
  438.          ( )   :grouping
  439.  
  440.          +     :catenation of bit strings
  441.  
  442.       The numerical value of a bit string (interpreted as an integer) is
  443.       symbolized by a lower case identifier preceding the string
  444.       expression and separated by a colon.  For example, in
  445.       "i:FIELD(8)", i symbolizes the numeric value of the 8 bit string
  446.       FIELD.
  447.  
  448.       Finally, we use Bobrow and Sutherland's symbolism for iteration of
  449.       a sub-string:  (STRING-EXPRESSION = n); denotes n occurrences of
  450.       STRING-EXPRESSION, implicitly catenated together.  Here any n
  451.       greater or equal to 0 is assumed unless n is explicitly
  452.       restricted.
  453.  
  454.    3.  Protocol Definition
  455.  
  456.       STREAM ::= (TRANSACTION = n) + [END-OF-DATA]
  457.  
  458.          That is, STREAM, the entire sequence of data on a particular
  459.          open channel, is a sequence of n TRANSACTIONS followed by an
  460.          END-OF-DATA marker (omitted if the sender aborts the channel).
  461.  
  462.       TRANSACTION ::= THEAD(72) + (RECORD = r) + ('0'(1) = f)
  463.  
  464.          That is, a transaction consists of a 72 bit header, r records,
  465.          and f filler bits; it may not exceed 880*8 bits.
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472. Braden                                                          [page 8]
  473.  
  474. RFC 740                                              RTB 42423 22 Nov 77
  475. NETRJS Protocol
  476.  
  477.  
  478.  
  479.       THEAD ::= X'FF'+f:FILLER(8)+SEQNUMB(16)+LENGTH(32)+X'00'
  480.  
  481.          Transactions are to be consecutively numbered in the SEQNUMB
  482.          field, starting with 0 in the first transaction after the
  483.          channel is (re-) opened.  The 32 bit LENGTH field gives the
  484.          total length in bits of the r RECORD's which follow.  For
  485.          convenience, the using site may add f additional filler bits at
  486.          the end of the transaction to reach a convenient word boundary
  487.          on his machine; the value f is transmitted in the FILLER field
  488.          of THEAD.
  489.  
  490.       RECORD ::= COMPRESSED | TRUNCATED
  491.  
  492.          RJS will accept intermixed RECORD's which are COMPRESSED or
  493.          TRUNCATED in an input stream.  RJS will send one or the other
  494.          format in the printer and punch streams to a given VRBT; the
  495.          choice is determined for each terminal id.
  496.  
  497.       COMPRESSED ::= '2'(2) + DEVID(6) + (STRING = p) + '0'(8)
  498.  
  499.       STRING     ::= ('6'(3) + i:DUPCOUNT(5))  |
  500.  
  501.          This form represents a string of i consecutive blanks
  502.  
  503.                      ('7'(3) + i:DUPCOUNT(5) + TEXTBYTE(8)) |
  504.  
  505.          This form represents string of i consecutive duplicates of
  506.          TEXTBYTE.
  507.  
  508.                      ('2'(2) + j:LENGTH(6) + (TEXTBYTE(8) = j))
  509.  
  510.          This form represents a string of j characters.
  511.  
  512.       TRUNCATED  ::= '3'(2) + DEVID(6) + n:COUNT(8) + (TEXTBYTE(8)=n)
  513.  
  514.       DEVID(6)   ::= DEVNO(3) + t:DEVTYPE(3)
  515.  
  516.          DEVID identifies a particular virtual device, i.e., it
  517.          identifies a channel.  DEVTYPE specifies the type of device, as
  518.          follows:
  519.  
  520.             t = 1:  Output to remote operator console
  521.                 2:  Input from remote operator console
  522.                 3:  Input from card reader
  523.                 4:  Output to printer
  524.                 5:  Output to card punch
  525.               6,7:  Unused
  526.  
  527.  
  528.  
  529.  
  530.  
  531. Braden                                                          [page 9]
  532.  
  533. RFC 740                                              RTB 42423 22 Nov 77
  534. NETRJS Protocol
  535.  
  536.  
  537.  
  538.          DEVNO identifies the particular device of type t at this remote
  539.          site; at present only DEVNO = 0 is possible.
  540.  
  541.       END-OF-DATA ::=X'FE'
  542.  
  543.          Signals end of job (output) or job stack (input).
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590. Braden                                                         [page 10]
  591.  
  592. RFC 740                                              RTB 42423 22 Nov 77
  593. NETRJS Protocol
  594.  
  595.  
  596.  
  597.                                APPENDIX B
  598.  
  599.                     Telnet for VRBT Operator Console
  600.  
  601.    The remote operator console connections use the ASCII Telnet
  602.    protocol. Specifically:
  603.  
  604.       1.  The following one-to-one character mappings are used for the
  605.       three EBCDIC graphics not in ASCII:
  606.  
  607.          ASCII in Telnet     |  NETRJS
  608.          ----------------------------------------------------
  609.          broken vertical bar |  solid vertical bar
  610.          tilde               |  not sign
  611.          back slash          |  cent sign
  612.  
  613.       2.  Telnet controls are ignored.
  614.  
  615.       3.  An operator console input line which exceeds 133 characters
  616.       (exclusive of CR LF) is truncated by NETRJS.
  617.  
  618.       4.  NETRJS accepts BS (Control-H) to delete a character and CAN
  619.       (Control-X) to delete the current line.  The sequence CR LF
  620.       terminates each input and output line.  HT (Control-I) is
  621.       translated to a single space. An ETX (Control-C) terminates
  622.       (aborts) the session.  All other ASCII control characters are
  623.       ignored.
  624.  
  625.       5.  NETRJS translates the six ASCII graphics with no equivalent in
  626.       EBCDIC into the character question mark ("?") on input.
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649. Braden                                                         [page 11]
  650.  
  651. RFC 740                                              RTB 42423 22 Nov 77
  652. NETRJS Protocol
  653.  
  654.  
  655.  
  656.                                APPENDIX C
  657.  
  658.                             Carriage Control
  659.  
  660.    The carriage control characters sent in a printer channel by NETRJS
  661.    conform to IBM's extended USASI code, defined by the following table:
  662.  
  663.       CODE       ACTION BEFORE WRITING RECORD
  664.       ----       ----------------------------
  665.       Blank      Space one line before printing
  666.       0          Space two lines before printing
  667.       -          Space three lines before printing
  668.       +          Suppress space before printing
  669.       1          Skip to channel 1
  670.       2          Skip to channel 2
  671.       3          Skip to channel 3
  672.       4          Skip to channel 4
  673.       5          Skip to channel 5
  674.       6          Skip to channel 6
  675.       7          Skip to channel 7
  676.       8          Skip to channel 8
  677.       9          Skip to channel 9
  678.       A          Skip to channel 10
  679.       B          Skip to channel 11
  680.       C          Skip to channel 12
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708. Braden                                                         [page 12]
  709.  
  710. RFC 740                                              RTB 42423 22 Nov 77
  711. NETRJS Protocol
  712.  
  713.  
  714.  
  715.                                APPENDIX D
  716.  
  717.                       Network/RJS Command Summary
  718.  
  719.    This section presents an overview of the RJS Operator Commands, for
  720.    the complete form and parameter specifications please see references
  721.    2 and 3.
  722.  
  723.    Terminal Control and Information Commands
  724.  
  725.       SIGNON       First command of a session; identifies VRBT by giving
  726.                    its terminal id.
  727.  
  728.       SIGNOFF      Last command of a session; RJS waits for any data
  729.                    transfer in progress to complete and then closes all
  730.                    connections.
  731.  
  732.       STATUS       Outputs on the remote operator console a complete
  733.                    list, or a summary, of all jobs in the system for
  734.                    this VRBT, with an indication of their processing
  735.                    status in the batch host.
  736.  
  737.       ALERT        Outputs on the remote operator console an "Alert"
  738.                    message, if any, from the computer operator.  The
  739.                    Alert message is also automatically sent when the
  740.                    user does a SIGNON, or whenever the message changes.
  741.  
  742.       MSG          Sends a message to the computer operator or to any
  743.                    other RJS terminal (real or virtual).  A message from
  744.                    the computer operator or another RJS terminal will
  745.                    automatically appear on the remote operator console.
  746.  
  747.    Job Control and Routing Commands
  748.  
  749.       Under CCN's job management system, the default destination for
  750.       output is the input source.  Thus, a job submitted under a given
  751.       VRBT will be returned to that VRBT (i.e., the same terminal id),
  752.       unless the user's JCL overrides the default destination.
  753.  
  754.       RJS places print and punch output destined for a particular remote
  755.       terminal into either an Active Queue or a Deferred Queue.  When
  756.       the user opens his print or punch output channel, RJS immediately
  757.       starts sending job output from the Active Queue, and continues
  758.       until this queue is empty.  Job output in the Deferred Queue, on
  759.       the other hand, must be called for by job name, (via a RESET
  760.       command from the remote operator)  before RJS will send it.  The
  761.       Active/Deferred choice for output from a job is determined by the
  762.  
  763.  
  764.  
  765.  
  766.  
  767. Braden                                                         [page 13]
  768.  
  769. RFC 740                                              RTB 42423 22 Nov 77
  770. NETRJS Protocol
  771.  
  772.  
  773.  
  774.       deferral status of the VRBT when the job is entered; the deferral
  775.       status, which is set to the Active option when the user signs on,
  776.       may be changed by the SET command.
  777.  
  778.       SET           Allows the remote user to change certain properties
  779.                     of his VRBT for the duration of the current session;
  780.       
  781.                     (a)  May change the default output destination to be
  782.                     another (real or virtual) RJS terminal or the
  783.                     central facility.
  784.       
  785.                     (b)  May change the deferral status of the VRBT.
  786.  
  787.       DEFER         Moves the print and punch output for a specified job
  788.                     or set of jobs from the Active Queue to the Deferred
  789.                     Queue. If the job's output is in the process of
  790.                     being transmitted over a channel, RJS aborts the
  791.                     channel and saves the current output location before
  792.                     moving the job to the Deferred Queue.  A subsequent
  793.                     RESET command will return it to the Active Queue
  794.                     with an implied Backspace (BSP).
  795.  
  796.       RESET         Moves specified job(s) from Deferred to Active Queue
  797.                     so they may be sent to user.  A specific list of job
  798.                     names or all jobs can be moved with one RESET
  799.                     command.
  800.  
  801.       ROUTE         Re-routes output of specified jobs (or all jobs)
  802.                     waiting in the Active and Deferred Queues for the
  803.                     VRBT.  The new destination may be any other RJS
  804.                     terminal or the central facility.
  805.  
  806.       ABORT         Cancels a job which was successfully submitted and
  807.                     awaiting execution or is currently executing.
  808.  
  809.    Output Stream Control Commands
  810.  
  811.       BSP (BACKSPACE)  "Backspaces" output stream within current sysout
  812.                     data set.  Actual amount backspaced depends upon
  813.                     sysout blocking but is roughly equivalent to a page
  814.                     on the line printer.
  815.  
  816.       CAN (CANCEL)  (a)  On an output channel, CAN causes the rest of
  817.                     the output in the sysout data set currently being
  818.                     transmitted to be omitted. Alternatively, may omit
  819.                     the rest of the sysout data sets for the job
  820.                     currently being transmitted; however, the remaining
  821.  
  822.  
  823.  
  824.  
  825.  
  826. Braden                                                         [page 14]
  827.  
  828. RFC 740                                              RTB 42423 22 Nov 77
  829. NETRJS Protocol
  830.  
  831.  
  832.  
  833.                     system and accounting messages will be sent.
  834.       
  835.                     (b)  On an input channel, CAN causes RJS to ignore
  836.                     the job currently being read.  However, the channel
  837.                     is not aborted as a result, and RJS will continue
  838.                     reading in jobs on the channel.
  839.       
  840.                     (c)  CAN can delete all sysout data sets for
  841.                     specified job(s) waiting in Active or Deferred
  842.                     Queue.
  843.  
  844.       RST (RESTART) (a)  Restarts a specified output stream at the
  845.                     beginning of the current sysout data set or,
  846.                     optionally, at the beginning of the job.
  847.       
  848.                     (b)  Marks as restarted specified job(s) whose
  849.                     transmission was earlier interrupted by system
  850.                     failure or user action (e.g., DEFER command or
  851.                     aborting the channel).  When RJS transmits these
  852.                     jobs again it will start at the beginning of the
  853.                     partially transmitted sysout data set or,
  854.                     optionally, at the beginning of the job. This
  855.                     function may be applied to jobs in either the Active
  856.                     or the Deferred Queue; however, if the job was in
  857.                     the Deferred Queue then RST also moves it to the
  858.                     Active Queue.  If the job was never transmitted, RST
  859.                     has no effect other than this queue movement.
  860.  
  861.       REPEAT        Sends additional copies of the output of specified
  862.                     jobs.
  863.  
  864.       EAM           Echoes the card reader stream back in the printer
  865.                     and/or punch stream.
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885. Braden                                                         [page 15]
  886.  
  887. RFC 740                                              RTB 42423 22 Nov 77
  888. NETRJS Protocol
  889.  
  890.  
  891.  
  892.                                APPENDIX E
  893.  
  894.                         NETRJS TERMINAL OPTIONS
  895.  
  896.    When a new NETRJS virtual terminal is defined, certain options are
  897.    available; these options are listed below.
  898.  
  899.       1. Truncated/Compressed Data Format
  900.  
  901.          A VRBT may use either the truncated data format (default) or
  902.          the compressed format for printer and punch output.  See
  903.          Reference 9 for discussion of the virtues of compression.
  904.  
  905.       2. Automatic Coldstart Job Resubmission
  906.  
  907.          If "R" (Restart) is specified in the accounting field on the
  908.          JOB card and if this option is chosen, RJS will automatically
  909.          resubmit the job from the beginning if the server operating
  910.          system should be "coldstarted" before all output from the job
  911.          is returned.  Otherwise, the job will be lost and must be
  912.          resubmitted from the remote terminal in case of a coldstart.
  913.  
  914.       3. Automatic Output RESTART
  915.  
  916.          With this option, transmission of printer output which is
  917.          interrupted by a broken connection always starts over at the
  918.          beginning.  Without this option, the output is backspaced
  919.          approximately one page when restarted, unless the user forces
  920.          the output to start over from the beginning with a RESTART
  921.          command when the printer channel is re-opened and before
  922.          printing begins.
  923.  
  924.       4. Password Protection
  925.  
  926.          This option allows a password to be supplied when a terminal is
  927.          signed on, preventing unauthorized use of the terminal ID.
  928.  
  929.       5. Suppression of Punch Separator and Large Letters.
  930.  
  931.          This option suppresses both separator cards which RJS normally
  932.          puts in front of each punched output deck, and separator pages
  933.          on printed output containing the job name in large block
  934.          letters.  These separators are an operational aid when the
  935.          ouptut is directed to a real printer or punch, but generally
  936.          undesirable for an ARPA user who is saving the output in a file
  937.          for on-line examination.
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944. Braden                                                         [page 16]
  945.  
  946. RFC 740                                              RTB 42423 22 Nov 77
  947. NETRJS Protocol
  948.  
  949.  
  950.  
  951.                                APPENDIX F
  952.  
  953.                   Character Translation by CCN Server
  954.  
  955.    A VRBT declares its character set for job input and output by the
  956.    initial connection socket it chooses. A VRBT can have the ASCII-68,
  957.    the ASCII-63, or the EBCDIC character set.  The ASCII-63 character
  958.    mapping was added to NETRJS at the request of users whose terminals
  959.    are equipped with keyboards like those found on the model 33
  960.    Teletype.
  961.  
  962.    Since CCN operates an EBCDIC machine, its NETRJS server translates
  963.    ASCII input to EBCDIC and translates printer output back to ASCII.
  964.    The details of this translation are described in the following.
  965.  
  966.    For ASCII-68, the following rules are used:
  967.  
  968.       1.  There is one-to-one mapping between the three ASCII characters
  969.           broken vertical bar, tilde, and back slash, which are not in
  970.           EBCDIC, and the three EBCDIC characters vertical bar, not
  971.           sign, and cent sign (respectively), which are not in ASCII.
  972.  
  973.       2.  The other six ASCII graphics not in EBCDIC are translated on
  974.           input to unused EBCDIC codes, shown in the table below.
  975.  
  976.       3.  The ASCII control DC4 is mapped to and from the EBCDIC control
  977.           TM.
  978.  
  979.       4.  The other EBCDIC characters not in ASCII are mapped in the
  980.           printer stream into the ASCII question mark.
  981.  
  982.    For ASCII-63, the same rules are used except that the ASCII-63 codes
  983.    X'60' and X'7B' - X'7E' are mapped as in the following table.
  984.  
  985.       EBCDIC              | ASCII-68 VRBT       | ASCII-63 VRBT
  986.       ---------------------------------------------------------------
  987.       vertical bar  X'4F' | vertical bar  X'7C' | open bracket  X'5B'
  988.       not sign      X'5F' | tilde         X'7E' | close bracket X'5D'
  989.       cent sign     X'4A' | back slash    X'5C' | back slash    X'5C'
  990.       underscore    X'6D' | underscore    X'5F' | left arrow    X'5F'
  991.       .             X'71' | up arrow      X'5E' | up arrow      X'5E'
  992.       open bracket  X'AD' | open bracket  X'5B' | .             X'7C'
  993.       close bracket X'BD' | close bracket X'5D' | .             X'7E'
  994.       .             X'8B' | open brace    X'7B' | .             X'7B'
  995.       .             X'9B' | close brace   X'7D' | .             X'7D'
  996.       .             X'79' | accent        X'60' | .             X'60'
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003. Braden                                                         [page 17]
  1004.  
  1005. RFC 740                                              RTB 42423 22 Nov 77
  1006. NETRJS Protocol
  1007.  
  1008.  
  1009.  
  1010.                                APPENDIX G
  1011.  
  1012.                                REFERENCES
  1013.  
  1014.    1. "Interim NETRJS Specifications", R. T. Braden.  RFC #189:  NIC
  1015.    #7133, July 15, 1971.
  1016.  
  1017.       This was the basic system programmer's definition document.  The
  1018.       proposed changes mentioned on the first page of RFC #189 were
  1019.       never implemented, since the DTP then in vogue became obsolete.
  1020.  
  1021.    2. "NETRJS Remote Operator Commands", R. T. Braden.  NIC #7182,
  1022.    August 9, 1971
  1023.  
  1024.       This document together with References 3 and 8 define the remote
  1025.       operator (i.e. user) command language for NETRJS, and form the
  1026.       basic user documentation for NETRJS at CCN.
  1027.  
  1028.    3. "Implementation of a Remote Job Service", V. Martin and T. W.
  1029.    Springer.  NIC #7183, July, 1971.
  1030.  
  1031.    4. "Remote Job Entry to CCN via UCLA Sigma 7; A scenario", UCLA/CCN.
  1032.    NIC #7748, November 15, 1971.
  1033.  
  1034.       This document described the first NETRJS user implementation
  1035.       available on a server host.  This program is no longer of general
  1036.       interest.
  1037.  
  1038.    5. "Using Network Remote Job Entry", E. F. Harslem.  RFC #307:  NIC
  1039.    #9258, February 24, 1972.
  1040.  
  1041.       This document is out of date, but describes generally the Tenex
  1042.       NETRJS user process "RJS".
  1043.  
  1044.    6. "EBCDIC/ASCII Mapping for Network RJS", R. T. Braden.  RFC #338:
  1045.    NIC #9931, May 17, 1972.
  1046.  
  1047.       The ASCII-63 mapping described here is no longer correct, but
  1048.       CCN's standard ASCII-68/EBCDIC mapping is described correctly.
  1049.       This information is accurately described in Appendix F of the
  1050.       current document.
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. Braden                                                         [page 18]
  1063.  
  1064. RFC 740                                              RTB 42423 22 Nov 77
  1065. NETRJS Protocol
  1066.  
  1067.  
  1068.  
  1069.    7. "NETRJT--Remote Job Service Protocol for TIP's", R. T. Braden. RFC
  1070.    #283: NIC 38165, December 20, 1971.
  1071.  
  1072.       This was an attempt to define an rje protocol to handle TIPs.
  1073.       Although NETRJT was never implemented, many of its features are
  1074.       incorporated in the current Network standard RJE protocol.
  1075.  
  1076.    8. "CCN NETRJS Server Messages to Remote User", R. T. Braden.  NIC
  1077.    #20268, November 26, 1973.
  1078.  
  1079.    9. "FTP Data Compression", R. T. Braden.  RFC #468:  NIC #14742,
  1080.    March 8, 1973.
  1081.  
  1082.    10. "Update on NETRJS", R. T. Braden.  RFC #599: NIC #20854, December
  1083.    13, 1973.
  1084.  
  1085.       This updated reference 1, the current document combines the two.
  1086.  
  1087.    11. "Network Remote Job Entry -- NETRJS", G. Hicks.  RFC #325: NIC
  1088.    9632, April 6, 1972.
  1089.  
  1090.    12. "CCNRJS: Remote Job Entry between Tenex and UCLA-CCN", D.
  1091.    Crocker.  NUTS Note 22, [ISI]<DOCUMENTATION>CCNRJS.DOC, March 5,
  1092.    1975.
  1093.  
  1094.    13. "Remote Job Service at UCSB", M. Krilanovich.  RFC #477: NIC
  1095.    #14992, May 23, 1973.
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121. Braden                                                         [page 19]